home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 476-500 / disk_498 / zoomdaemon / zoom-daemon.doc < prev    next >
Text File  |  1992-05-06  |  5KB  |  103 lines
  1. OVERVIEW:
  2.  
  3. Zoom-Daemon is a program that attaches a ZOOM GADGET to each Intuition window
  4. which causes the window to expand to the full size of the screen or contract 
  5. to the window's minimum size when it is pressed.  Pressing the gadget a second
  6. time restores the window to its original size.
  7.  
  8.  
  9. HOW TO USE ZOOM-DAEMON:
  10.  
  11. You should place Zoom-Daemon in your C: directory (or in your current path),
  12. and Zoom-Handler in the L: directory (or in the current directory).  To start
  13. Zoom-Daemon, simply type Zoom-Daemon at the CLI prompt:
  14.  
  15.     1> Zoom-Daemon
  16.  
  17. You do not need to RUN Zoom-Daemon, since Zoom-Daemon loads the handler code
  18. separately, sets up the handler, and then exits.  To remove the daemon, 
  19. simply issue the Zoom-Daemon command a second time.
  20.  
  21. Once the Zoom-Daemon is running, new windows that are opened may include a
  22. Zoom Gadget which should appear to the left of the depth gadgets in the upper
  23. right-hand corner of the window.  The Zoom Gadget has a large dark square
  24. with a smaller light-colored square inside it (if youy are using the standard
  25. workbench colors).  If you press this gadget, the window will grow in size to
  26. fill the entire screen.  Pressing the gadget a second time causes the window
  27. to return to its original size.  If you press and hold the Zoom Gadget and
  28. click the right mouse button while the zoom gadget is still active (a process
  29. called "left-right clicking"), then the window will be reduced to its smallest
  30. allowable size.  Left-right clicking the Zoom Gadget a second time restores
  31. the window to its original size.
  32.  
  33.  
  34.  
  35. USAGE NOTES:
  36.  
  37. Zoom-Daemon only adds a Zoom Gadget to a window when it meets one of two 
  38. conditions:  1) it has a SIZING gadget, or 2) it has the NEWSIZE flag set
  39. in its IDCMPFlags field. (See "Intuition:  The Amiga User Interface" for a
  40. description of the IDCMP flags, and the window fields discussed below).
  41. Windows with neither of these features probably do not know how to handle
  42. window size changes (or could not take advantage of a larger window anyway),
  43. so no Zoom Gadget is added to them for this reason.
  44.  
  45. Zoom-Daemon will not increase the size of a window past its MaxWidth or
  46. MaxHeight values, even if they are smaller than the size of the screen 
  47. Zoom-Daemon assumes that the application knew what it wanted when it set the
  48. maximum size.  Some older programs may have the maximum size set to the 
  49. standard size of the Workbench screen (640x200) and if you use overscan
  50. mode, these windows will not zoom out to the full size of the screen.
  51.  
  52. Zoom-Daemon will not decrease the size of a window past its MinWidth and
  53. MinHeight values, nor to a size that would place the Zoom Gadget outside the
  54. visible portion of the window.  This is an attempt to guarantee that the
  55. zoom gadget is always available to resize the window.
  56.  
  57. Pressing the Zoom Gadget (without pressing the right mouse button) zooms
  58. the window to its full size even if the window is currently shrunken. 
  59. Similarly, left-right clicking the Zoom gadget shrinks the window to its
  60. minimum size even if the window is zoomed.  Thus it is possible to get to
  61. any of the three possible sizes (minimum, normal, maximum) from any other 
  62. size:  from minimum size left-right clicking gets to normal size, while
  63. clicking gets to maximum; from normal size, left-right clicking gets to
  64. minimum size while clicking gets to maximum; and from maximum left-right
  65. clicking gets to minimum size while clicking gets to normal size.
  66.  
  67. If you remove the Zoom-Daemon while windows containing a Zoom Gadget are
  68. still open, Zoom-Daemon will remove the Zoom Gadgets automatically.
  69.  
  70. You can make Zoom-Daemon part of your standard working environment by adding
  71. the "ZOOM-DAEMON" command (or "ZOOM-DAEMON > NIL:") to the startup-sequence
  72. file in the S: directory on your boot disk.
  73.  
  74.  
  75. COMPILING ZOOM-DAEMON:
  76.  
  77. Zoom-Daemon was developed using the Lattice C compiler v4.0 on a 512K
  78. Amiga 1000.  It probably will need to be modified to work with the
  79. Manx Aztec C compiler.  To compile and link Zoom-Daemon, use the following 
  80. commands (these appear in Zoom-Daemon.com, distributed with the source code):
  81.  
  82.         1> lc -b0 -v  -M Zoom-Main Zoom-Handler Zoom-Setup
  83.         1> lc -b0 -ad -M Zoom-Image
  84.         1> asm Zoom-Stubs
  85.         1> blink with Zoom-Daemon.lnk
  86.         1> blink with Zoom-Handler.lnk
  87.  
  88. The -v -b0  and -ad options are required.  You can add -r if you like.
  89. The -M is to compile only those source files that have been updated since the
  90. last compile.
  91.  
  92.  
  93. AUTHOR:
  94.  
  95. Zoom-Daemon and Zoom-Handler
  96. Copyright (c) 1989 by Davide P. Cervone, all rights reserved.
  97.  
  98. Davide P. Cervone
  99. Department of Mathematics, Box 1917                 ST402523@BROWNVM.BITNET
  100. Brown University                                    st402523@brownvm.brown.edu
  101. Providence, Rhode Island  02912                     dpvc@fermat.math.brown.edu
  102.  
  103.